home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / ums / kms190b.lha / KMS / Doc / KMSAM.doc < prev    next >
Text File  |  1994-09-10  |  10KB  |  260 lines
  1.  
  2.  
  3.  
  4.          KMSAM 1.24 -*- KMS Area Manager     ©1994 Thomas Schwarz
  5.          ========================================================
  6.  
  7.  
  8.  
  9.                                Documentation
  10.                                =============
  11.  
  12.  
  13.  
  14. Introduction:
  15. -------------
  16.  
  17. KMSAM is a GUI for editing the area  data  of  KMS,  my  famous  "Karfunkel
  18. Mailbox  System"  and  is  based  on  MUI, the even more famous "Magic User
  19. Interface" by Stefan Stuntz which has to be installed  on  your  system  in
  20. order to be able to use KMSAM.
  21.  
  22. KMSAM makes you able to change every data item of a KMS message area  which
  23. may be edited by the KMS internal command #11 "BRETTED", but on a much more
  24. comfortable graphically nice-looking astonishingly pretty way.
  25.  
  26. KMSAM  is  designed  especially  for use with KMS and is not intended to be
  27. used  by anything or anybody for anything else. (But surely I'm not able to
  28. stop  you from abusing it anyway. If you abuse it, please tell me which way
  29. you do it. I can't imagine one :-)
  30.  
  31.  
  32.  
  33. Call-Syntax:
  34. ------------
  35.  
  36. KMSAM [Areaname/-path]
  37.  
  38.  
  39.  
  40. Parameters:
  41. -----------
  42.  
  43. Areaname/-path Optional: If you  supply  the name or complete path of a KMS
  44.                area as argument, KMSUM directly presents the editing window
  45.                for this  area, if  it already  exists, or lets you create a
  46.                new one with the given name.
  47.  
  48.  
  49.  
  50. Description:
  51. ------------
  52.  
  53. Main Window:
  54. ++++++++++++
  55.  
  56. If KMSAM is called without parameters, you will see the main window with  a
  57. listview on the left side and several buttons on the left and bottom of the
  58. window. In the list there always are shown all the KMS areas of the current
  59. level.  You  change  to  the next deeper tree-level by double clicking on a
  60. name in the list or selecting the "Children"-button. You climb one level up
  61. by  selecting "Parent". In the top-level there always is just one area, the
  62. one for private mail.
  63.  
  64. With a single click on an area name you select this for further editing  by
  65. using all the buttons on the right side of the KMSAM window.
  66.  
  67. Available buttons/actions in the main KMSAM window:
  68.  
  69. [   Up   ]        Move area one position up in the list.
  70. [  Down  ]        Move area one position down in the list.
  71.  
  72. [  Cut   ]        Remove an area from the list and save it for later
  73.                   reincarnation (->Paste).
  74. [  Copy  ]        Save the data of current area for later cloning
  75.                   (->Paste).
  76. [ Paste  ]        If you did a "Cut" or "Copy" before, create an area
  77.                   with the saved data at the current position in the list.
  78.  
  79. [  Sort  ]        Sort areas alphabetically.
  80.  
  81. [  Add   ]        Add new area to the list at the current position.
  82. [ Remove ]        Say Good Bye to the current area.
  83.  
  84. [  Edit  ]        Change data of currently selected area.
  85.  
  86. You leave the program by clicking the  window  close  gadget  or  selecting
  87. "Quit" from the pull down menu.
  88.  
  89. Editing Window:
  90. +++++++++++++++
  91.  
  92. If you choose "Add" or "Edit" in the main window,  the  KMSAM  Area  Editor
  93. window   is   opened.   Here   you   get  the  possibility  to  change  the
  94. characteristics of the selected area.
  95.  
  96. I think the  meaning  of  all  the  available  string,  slider,  cycle  and
  97. checkmark  gadgets  are  quite  self  explanatory,  if  you are familiar to
  98. editing userdata with the KMS internal command #11  "BRETTED".  So  I  will
  99. make  my life easy here by just saying: "Read the documentation of BRETTED"
  100. :-)
  101.  
  102. The two available buttons do the following:
  103.  
  104. [  Use   ]        Accept changes and return to the main window.
  105. [ Cancel ]        Leave editor window without changing anything.
  106.  
  107.  
  108.  
  109. Distribution:
  110. -------------
  111.  
  112. The "Karfunkel Mailbox System (KMS)" and "KMS Area Mananger (KMSAM)" are
  113. Copyright ©1994 by Thomas Schwarz.
  114. All Rights Reserved.
  115.  
  116. "KMSAM" is only to be distributed as part of the KMS package.  I  mean  it.
  117. Please refer to the KMS documentation for further distribution information.
  118.  
  119.  
  120.  
  121. Author information:
  122. -------------------
  123.  
  124. It's me :-)
  125.  
  126. Thomas Schwarz
  127. Gieshügeler Straße 26
  128. 97218 Gerbrunn
  129. Germany
  130.  
  131. E-Mail: kmshq@bmagic.mayn.sub.de
  132.         Thomas_Schwarz@wue.maus.de
  133.  
  134.  
  135.  
  136. Acknowledgements:
  137. -----------------
  138.  
  139.                           This application uses
  140.  
  141.  
  142.                         MUI - MagicUserInterface
  143.  
  144.                 (c) Copyright 1993/94 by Stefan Stuntz
  145.  
  146.  
  147. MUI is a system to generate and maintain graphical user interfaces. With
  148. the  aid  of  a  preferences program, the user of an application has the
  149. ability to customize the outfit according to his personal taste.
  150.  
  151. MUI is distributed as shareware. To obtain a complete package containing
  152. lots of examples and more information about registration please look for
  153. a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
  154. your local bulletin boards or on public domain disks.
  155.  
  156.           If you want to register directly, feel free to send
  157.  
  158.  
  159.                          DM 30.-  or  US$ 20.-
  160.  
  161.                                   to
  162.  
  163.                              Stefan Stuntz
  164.                         Eduard-Spranger-Straße 7
  165.                              80935 München
  166.                                 GERMANY
  167.  
  168.  
  169.  
  170. Copyright notices:
  171. ------------------
  172.  
  173. Unix is a registered trademark of AT&T
  174.  
  175. Amiga is a registered trademark of Commodore Business Machines, Inc.
  176.  
  177. AmigaOS is a registered trademark of Commodore Business Machines, Inc.
  178.  
  179. KMS and KMSAM are not registered trademarks, but using them without
  180. permission is bad for your conscience.
  181.  
  182.  
  183.  
  184. Disclaimer:
  185. -----------
  186.  
  187.                           *** STANDARD DISCLAIMER ***
  188.  
  189.    This product is meant for educational purposes only.  Any  resemblance
  190.    to real persons, living or dead is  purely  coincidental.  Void  where
  191.    prohibited. Some assembly required. List each check separately by bank
  192.    number. Batteries not included. Contents may settle  during  shipment.
  193.    Use only as directed. No other warranty expressed or implied.  Do  not
  194.    use while operating a motor vehicle or heavy equipment.  Postage  will
  195.    be paid by addressee. Subject to CAB approval. This is not an offer to
  196.    sell securities. Apply only to affected area. May be too  intense  for
  197.    some viewers. Do not stamp. Use other side  for  additional  listings.
  198.    For recreational use only. Do not disturb. All models over 18 years of
  199.    age.   If   condition   persists,   consult   your    physician.    No
  200.    user-serviceable parts  inside.  Freshest  if  eaten  before  date  on
  201.    carton. Subject to change without notice. Times approximate. Simulated
  202.    picture. No postage necessary if mailed in the United States. Breaking
  203.    seal constitutes acceptance of agreement. For off-road  use  only.  As
  204.    seen on TV. One size fits all. Many suitcases look alike.  Contains  a
  205.    substantial amount of non-tobacco ingredients. Colors  may,  in  time,
  206.    fade. We have sent the forms which seem to be right for you.  Slippery
  207.    when wet. For office use only. Not affiliated with  the  American  Red
  208.    Cross. Drop in any mailbox. Edited for television. Keep cool;  process
  209.    promptly. Post office will  not  deliver  without  postage.  List  was
  210.    current at time of printing. Return to sender, no forwarding order  on
  211.    file,  unable  to  forward.  Not  responsible  for  direct,  indirect,
  212.    incidental or consequential damages resulting from any  defect,  error
  213.    or failure to  perform.  At  participating  locations  only.  Not  the
  214.    Beatles. Penalty for private use. See label for sequence.  Substantial
  215.    penalty for early withdrawal. Do not write below  this  line.  Falling
  216.    rock. Lost ticket pays maximum rate.  Your  cancelled  check  is  your
  217.    receipt. Add  toner.  Place  stamp  here.  Avoid  contact  with  skin.
  218.    Sanitized for your protection. Be sure each item is properly endorsed.
  219.    Sign here  without  admitting  guilt.  Slightly  higher  west  of  the
  220.    Mississippi. Employees and their families are not eligible. Beware  of
  221.    dog. Contestants have been briefed on some questions before the  show.
  222.    Limited time offer, call now to insure prompt delivery.  You  must  be
  223.    present to win. No passes accepted for this  engagement.  No  purchase
  224.    necessary. Processed at location stamped in code  at  top  of  carton.
  225.    Shading within a garment may occur. Use only in well-ventilated  area.
  226.    Keep away from fire or flame. Replace with  same  type.  Approved  for
  227.    veterans. Booths for two or more. Check here if tax  deductible.  Some
  228.    equipment shown is optional. Price does not include taxes. No Canadian
  229.    coins. Not recommended for children. Prerecorded for this  time  zone.
  230.    Reproduction strictly prohibited. No solicitors. No alcohol, dogs,  or
  231.    horses. No anchovies unless otherwise specified.  Restaurant  package,
  232.    not for resale. List at least two alternate dates. First pull up, then
  233.    pull down. Call toll free before digging. Driver does not carry  cash.
  234.    Some  of  the  trademarks  mentioned  in  this  product   appear   for
  235.    identification purposes only. Record additional transactions  on  back
  236.    of previous stub. Decision of judges is final.
  237.  
  238.    This supersedes all previous notices.
  239.  
  240.  
  241.  
  242. Quote of the day:
  243. -----------------
  244.  
  245.    "All right," said Masklin. "But you're not to fly down low again and try
  246.   to read the signposts. Every time you do that, humans rush into the streets
  247.                   and we get lots of shouting on the radio."
  248.      "That's right." said the Thing. "People are bound to get excited when
  249.       they see a ten-million-ton starship trying to fly down the street."
  250.                               -- (Terry Pratchett, Wings)
  251.  
  252.  
  253.  
  254. Last words:
  255. -----------
  256.  
  257. Perhaps you wonder why this documentation is written in English while KMS
  258. in general is a German system? Well, I'm practising my English :-)
  259.  
  260.